home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / lib / c / etc / RCS / mktemp.man,v < prev    next >
Text File  |  1990-03-19  |  2KB  |  72 lines

  1. head     1.2;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.2
  10. date     90.03.19.13.32.50;  author shirriff;  state Exp;
  11. branches ;
  12. next     1.1;
  13.  
  14. 1.1
  15. date     90.02.28.21.57.40;  author shirriff;  state Exp;
  16. branches ;
  17. next     ;
  18.  
  19.  
  20. desc
  21. @@
  22.  
  23.  
  24. 1.2
  25. log
  26. @Fixed man page so "man mkstemp" would work.
  27. @
  28. text
  29. @.\"    @@(#)mktemp.3    6.3 (Berkeley) 4/10/87
  30. .\"
  31. .TH MKTEMP 3  "April 10, 1987"
  32. .AT 3
  33. .SH NAME
  34. mktemp, mkstemp \- make a unique file name
  35. .SH SYNOPSIS
  36. .nf
  37. .B char *mktemp(template)
  38. .B char *template;
  39. .sp
  40. .B mkstemp(template)
  41. .B char *template;
  42. .fi
  43. .SH DESCRIPTION
  44. \fIMktemp\fP creates a unique file name and returns the address of
  45. the template.  The template should contain a file name with trailing
  46. \fIX\fP's, normally something like \fI/tmp/tempXXXXXX\fP.  The \fIX\fP's
  47. are replaced by the current process number and/or a unique letter
  48. combination.  \fIMkstemp\fP makes the same replacement to the template
  49. but opens the template file and returns a file descriptor open for
  50. reading and writing.  \fIMkstemp\fP avoids the race between testing
  51. whether the file exists and opening it for use.  The number of file
  52. name combinations \fImktemp\fP and \fImkstemp\fP will try depends on
  53. the number of \fIX\fP's placed on the end of the template; six \fIX\fP's
  54. will result in them trying roughly 26 ** 6 combinations.
  55. .SH "SEE ALSO"
  56. access(2), getpid(2), open(2)
  57. .SH DIAGNOSTICS
  58. \fIMktemp\fP returns NULL on failure, \fImkstemp\fP returns -1 if no
  59. suitable file could be created.
  60. @
  61.  
  62.  
  63. 1.1
  64. log
  65. @Initial revision
  66. @
  67. text
  68. @d6 1
  69. a6 1
  70. mktemp \- make a unique file name
  71. @
  72.